¿Cómo usar chronicle?

Creando archivos R Markdown a través de las funciones add_*

library(chronicle)

reporte_nuevo <- add_title(title = 'Así se ve un reporte de chronicle', title_level = 1) %>%
  add_density(dt = iris, groups = 'Species', value = 'Sepal.Length', faceted = F) %>%
  add_boxplot(dt = iris, groups = 'Species', value = 'Sepal.Length') %>%
  add_barplot(dt = iris, bars = 'Species', value = 'Sepal.Length') %>%
  add_table(table = head(iris),
          table_title = 'La famosa tabla iris',
          html_table_type = 'kable') %>%
  add_table(table = ggplot2::mpg[],
            table_title = 'Y esta es mpg de ggplot2',
            html_table_type = 'DT')
cat(reporte_nuevo)

## 
## 
## # Así se ve un reporte de chronicle
## 
## ## Distribution of Sepal.Length by Species
## ```{r, echo =  FALSE, message =  FALSE, warning =  FALSE}
## make_density(dt = iris, value = 'Sepal.Length', groups = 'Species', faceted = 'FALSE', scales = 'fixed')
## ```
## 
## ## Distribution of Sepal.Length by Species
## ```{r, echo =  FALSE, message =  FALSE, warning =  FALSE}
## make_boxplot(dt = iris, value = 'Sepal.Length', groups = 'Species', jitter = 'TRUE')
## ```
## 
## ## Sepal.Length by Species
## ```{r, echo =  FALSE, message =  FALSE, warning =  FALSE}
## make_barplot(dt = iris, bars = 'Species', value = 'Sepal.Length', horizontal = 'FALSE', sort_by_value = 'FALSE', sort_decreasing = 'TRUE', ggtheme = 'minimal')
## ```
## 
## ## La famosa tabla iris
## 
## ```{r, echo = FALSE, message = FALSE, warning = FALSE}
## knitr::kable(head(iris))
## ```
## 
## ## Y esta es mpg de ggplot2
## 
## ```{r, echo = FALSE, message = FALSE, warning = FALSE}
## DT::datatable(ggplot2::mpg[])
## ```

Las llamadas de las funciones make_*

Para cada funcion add_* (casi), existe una función make_*. Estas son las funciones que realmente crean los gráficos con todas sus especificaciones.

make_barplot(dt = ggplot2::mpg,
             value = 'cty',
             bars = 'manufacturer',
             break_bars_by = 'model',
             horizontal = TRUE,
             sort_by_value = TRUE)

Estas funciones se pueden llamar independientemente y agregar a reportes ya existentes, aplicaciones Shiny o cualquier otro lugar donde se pueda montar un gráfico html. Actualmente, chronicle tiene make_barplot, make_boxplot, make_density, make_dygraph, make_histogram, make_lineplot, make_scatterplot y make_violin.

Compilación del R Markdown

La función render_report() se encarga de construir el encabezado en yaml y de hacer la compilación del archivo directamente desde el ambiente global, es decir, con todos los objetos que se hayan cargado en memoria al momento de llamar la función. Aquí se pueden seleccionar varios formatos distintos e incluso compilar en varios formatos desde una misma llamada, y el parámetro keep_rmd permite conservar el (los) archivo(s) R Markdown.

chronicle::render_report(filename = 'conectaR2021',
  title = 'Gramática de capas para reportes con \{chronicle\}',
  author = 'Philippe Heymans Smith @pheymanss',
  keep_rmd = TRUE,
  render_html = TRUE,
  table_of_content = FALSE,
  number_sections = FALSE,
  highlight = 'vignette')